home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / u_man / cat1 / X11 / xlbiff.z / xlbiff
Text File  |  1998-10-30  |  22KB  |  529 lines
  1.  
  2.  
  3.  
  4.      XXXXLLLLBBBBIIIIFFFFFFFF((((1111))))        UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((4444 OOOOccccttttoooobbbbeeeerrrr 1111999999991111))))         XXXXLLLLBBBBIIIIFFFFFFFF((((1111))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           xlbiff - mailbox message previewer for X
  10.  
  11.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.           xxxxllllbbbbiiiiffffffff [ -_o_p_t_i_o_n ... ]
  13.  
  14.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.           The _x_l_b_i_f_f program lurks in the background, watching your
  16.           mailbox file, waiting for new mail.  When mail arrives, it
  17.           invokes the MH _s_c_a_n(1) command and pops up a window with the
  18.           results.  Clicking the left mouse button anywhere in this
  19.           window makes it go away.  The window will also disappear if
  20.           iconified or if the mailbox size drops to zero.
  21.  
  22.      OOOOPPPPTTTTIIIIOOOONNNNSSSS
  23.           _X_l_b_i_f_f accepts all of the standard X Toolkit command line
  24.           options along with the additional options listed below:
  25.  
  26.           ----hhhheeeellllpppp   This option indicates that a brief summary of the
  27.                   allowed options should be printed on standard
  28.                   output.
  29.  
  30.           ----bbbboooottttttttoooommmm This option tells _x_l_b_i_f_f to realize/unrealize() the
  31.                   output window instead of using XtPopup/down().  This
  32.                   has the effect of causing the window manager to
  33.                   reposition the window each time it pops up, and is
  34.                   useful for when you specify negative Y coordinates,
  35.                   ie, at the bottom of the screen.  Running _x_l_b_i_f_f in
  36.                   this situation without -bottom would cause new lines
  37.                   to run off the bottom edge of the screen.
  38.  
  39.           ++++bbbboooottttttttoooommmm Opposite of -bottom.
  40.  
  41.           ----ffffiiiilllleeee _f_i_l_e_n_a_m_e
  42.                   This option specifies the name of the file which
  43.                   should be monitored.  By default, it watches
  44.                   /usr/spool/mail/_u_s_e_r_n_a_m_e, where _u_s_e_r_n_a_m_e is your
  45.                   login name.
  46.  
  47.           ----rrrroooowwwwssss _h_e_i_g_h_t
  48.                   This option specifies the maximum height, in lines
  49.                   of text, of the _x_l_b_i_f_f window.  The default is 20.
  50.  
  51.           ----ccccoooolllluuuummmmnnnnssss _w_i_d_t_h
  52.                   This option specifies the maximum width, in
  53.                   characters, of the _x_l_b_i_f_f window.  The default is
  54.                   80.
  55.  
  56.           ----rrrreeeesssseeeettttSSSSaaaavvvveeeerrrr
  57.                   If this option is set, _x_l_b_i_f_f will reset the screen
  58.                   saver when new mail comes in.  This is useful if
  59.                   you're doing something near your workstation but not
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 4/30/98)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXLLLLBBBBIIIIFFFFFFFF((((1111))))        UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((4444 OOOOccccttttoooobbbbeeeerrrr 1111999999991111))))         XXXXLLLLBBBBIIIIFFFFFFFF((((1111))))
  71.  
  72.  
  73.  
  74.                   on it.
  75.  
  76.           ++++rrrreeeesssseeeettttSSSSaaaavvvveeeerrrr
  77.                   Opposite of -resetSaver.
  78.  
  79.           ----uuuuppppddddaaaatttteeee _s_e_c_o_n_d_s
  80.                   This option specifies the frequency in seconds at
  81.                   which _x_l_b_i_f_f should update its display.  The default
  82.                   is 15 seconds.
  83.  
  84.           ----vvvvoooolllluuuummmmeeee _p_e_r_c_e_n_t_a_g_e
  85.                   This option specifies how loud the bell should be
  86.                   rung when new mail comes in.
  87.  
  88.           The following standard X Toolkit command line arguments are
  89.           commonly used with _x_l_b_i_f_f:
  90.  
  91.           ----ddddiiiissssppppllllaaaayyyy _d_i_s_p_l_a_y
  92.                   This option specifies the X server to contact.
  93.  
  94.           ----ggggeeeeoooommmmeeeettttrrrryyyy +_x+_y
  95.                   This option specifies the preferred position of the
  96.                   scan window.
  97.  
  98.           ----bbbbgggg _c_o_l_o_r
  99.                   This option specifies the color to use for the
  100.                   background of the window.
  101.  
  102.           ----ffffgggg _c_o_l_o_r
  103.                   This option specifies the color to use for the
  104.                   foreground of the window.
  105.  
  106.           ----xxxxrrrrmmmm _r_e_s_o_u_r_c_e_s_t_r_i_n_g
  107.                   This option specifies a resource string to be used.
  108.                   This is especially useful for setting resources that
  109.                   do not have separate command line options.
  110.  
  111.      RRRREEEESSSSOOOOUUUURRRRCCCCEEEESSSS
  112.           The application class name is XLbiff.  It understands all of
  113.           the core resource names and classes as well as:
  114.  
  115.           bbbboooottttttttoooommmm ((((class BBBBoooottttttttoooommmm))))
  116.                   Same as the ----bbbboooottttttttoooommmm option.
  117.  
  118.           ffffiiiilllleeee ((((class FFFFiiiilllleeee))))
  119.                   Same as the ----ffffiiiilllleeee option.
  120.  
  121.           ssssccccaaaannnnCCCCoooommmmmmmmaaaannnndddd ((((class SSSSccccaaaannnnCCCCoooommmmmmmmaaaannnndddd))))
  122.                   Specifies a shell command to be executed to list the
  123.                   contents of mailbox ffffiiiilllleeee.  The specified string
  124.                   value is used as the argument to a _s_y_s_t_e_m(3) call
  125.                   and may therefore contain i/o redirection.  The
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 4/30/98)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      XXXXLLLLBBBBIIIIFFFFFFFF((((1111))))        UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((4444 OOOOccccttttoooobbbbeeeerrrr 1111999999991111))))         XXXXLLLLBBBBIIIIFFFFFFFF((((1111))))
  137.  
  138.  
  139.  
  140.                   command's stdout is used to generate the window.
  141.                   Internally, the command is generated as
  142.  
  143.                                 sprintf(buf, scanCommand, file, columns)
  144.  
  145.                   so a %s and %d respectively in ssssccccaaaannnnCCCCoooommmmmmmmaaaannnndddd will
  146.                   generate the values of ffffiiiilllleeee and ccccoooolllluuuummmmnnnnssss.
  147.  
  148.           rrrreeeesssseeeettttSSSSaaaavvvveeeerrrr ((((class RRRReeeesssseeeettttSSSSaaaavvvveeeerrrr))))
  149.                   Same as the ----rrrreeeesssseeeettttSSSSaaaavvvveeeerrrr option.
  150.  
  151.           uuuuppppddddaaaatttteeee ((((class IIIInnnntttteeeerrrrvvvvaaaallll))))
  152.                   Same as the ----uuuuppppddddaaaatttteeee option.
  153.  
  154.           ccccoooolllluuuummmmnnnnssss ((((class CCCCoooolllluuuummmmnnnnssss))))
  155.                   Same as the ----ccccoooolllluuuummmmnnnnssss option.
  156.  
  157.           rrrroooowwwwssss ((((class RRRRoooowwwwssss))))
  158.                   Specifies the maximum height, in lines, of the
  159.                   _x_l_b_i_f_f window.  The default is 20.
  160.  
  161.           vvvvoooolllluuuummmmeeee ((((class VVVVoooolllluuuummmmeeee))))
  162.                   Same as the ----vvvvoooolllluuuummmmeeee option.
  163.  
  164.      AAAACCCCTTTTIIIIOOOONNNNSSSS
  165.           _X_l_b_i_f_f provides the following actions for use in event
  166.           translations:
  167.  
  168.           ppppooooppppddddoooowwwwnnnn(((())))
  169.                   This action causes the window to vanish.
  170.  
  171.           eeeexxxxiiiitttt(((())))  This action causes _x_l_b_i_f_f to exit.
  172.  
  173.           The default translations are
  174.  
  175.                   <Button1Press>:  popdown()
  176.                   <Button3Press>:  exit()
  177.  
  178.  
  179.      EEEENNNNVVVVIIIIRRRROOOONNNNMMMMEEEENNNNTTTT
  180.           DDDDIIIISSSSPPPPLLLLAAAAYYYY is used to get the default host and display number.
  181.  
  182.      FFFFIIIILLLLEEEESSSS
  183.           /usr/spool/mail/_u_s_e_r_n_a_m_e
  184.                   default mail file to check.
  185.  
  186.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  187.           _X(1), _s_c_a_n(1)
  188.  
  189.      BBBBUUUUGGGGSSSS
  190.           specifying dimensions in -geometry causes badness.
  191.  
  192.  
  193.  
  194.  
  195.      Page 3                                          (printed 4/30/98)
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.      XXXXLLLLBBBBIIIIFFFFFFFF((((1111))))        UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((4444 OOOOccccttttoooobbbbeeeerrrr 1111999999991111))))         XXXXLLLLBBBBIIIIFFFFFFFF((((1111))))
  203.  
  204.  
  205.  
  206.      CCCCOOOOPPPPYYYYRRRRIIIIGGGGHHHHTTTT
  207.           Copyright 1991, Digital Equipment Corporation.  See the
  208.           source code for a full statement of rights and permissions.
  209.  
  210.      AAAAUUUUTTTTHHHHOOOORRRR
  211.           Ed Santiago, santiago@pa.dec.com
  212.  
  213.      AAAACCCCKKKKNNNNOOOOWWWWLLLLEEEEDDDDGGGGEEEEMMMMEEEENNNNTTTTSSSS
  214.           _X_l_b_i_f_f took shape around the xxxxggggooooooooddddbbbbyyyyeeee sample program in the
  215.           O'Reilly _X _T_o_o_l_k_i_t _I_n_t_r_i_n_s_i_c_s _P_r_o_g_r_a_m_m_i_n_g _M_a_n_u_a_l.  A lot of
  216.           code was stolen from xxxxbbbbiiiiffffffff, including this man page.  Thanks
  217.           also to Stephen Gildea (gildea@expo.lcs.mit.edu) for the
  218.           many, many contributions that made _x_l_b_i_f_f grow from a
  219.           midnight hack to a more mature product.
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.      Page 4                                          (printed 4/30/98)
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.      XXXXLLLLBBBBIIIIFFFFFFFF((((1111))))        UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((4444 OOOOccccttttoooobbbbeeeerrrr 1111999999991111))))         XXXXLLLLBBBBIIIIFFFFFFFF((((1111))))
  269.  
  270.  
  271.  
  272.      NNNNAAAAMMMMEEEE
  273.           xlbiff - mailbox message previewer for X
  274.  
  275.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  276.           xxxxllllbbbbiiiiffffffff [ -_o_p_t_i_o_n ... ]
  277.  
  278.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  279.           The _x_l_b_i_f_f program lurks in the background, watching your
  280.           mailbox file, waiting for new mail.  When mail arrives, it
  281.           invokes the MH _s_c_a_n(1) command and pops up a window with the
  282.           results.  Clicking the left mouse button anywhere in this
  283.           window makes it go away.  The window will also disappear if
  284.           iconified or if the mailbox size drops to zero.
  285.  
  286.      OOOOPPPPTTTTIIIIOOOONNNNSSSS
  287.           _X_l_b_i_f_f accepts all of the standard X Toolkit command line
  288.           options along with the additional options listed below:
  289.  
  290.           ----hhhheeeellllpppp   This option indicates that a brief summary of the
  291.                   allowed options should be printed on standard
  292.                   output.
  293.  
  294.           ----bbbboooottttttttoooommmm This option tells _x_l_b_i_f_f to realize/unrealize() the
  295.                   output window instead of using XtPopup/down().  This
  296.                   has the effect of causing the window manager to
  297.                   reposition the window each time it pops up, and is
  298.                   useful for when you specify negative Y coordinates,
  299.                   ie, at the bottom of the screen.  Running _x_l_b_i_f_f in
  300.                   this situation without -bottom would cause new lines
  301.                   to run off the bottom edge of the screen.
  302.  
  303.           ++++bbbboooottttttttoooommmm Opposite of -bottom.
  304.  
  305.           ----ffffiiiilllleeee _f_i_l_e_n_a_m_e
  306.                   This option specifies the name of the file which
  307.                   should be monitored.  By default, it watches
  308.                   /usr/spool/mail/_u_s_e_r_n_a_m_e, where _u_s_e_r_n_a_m_e is your
  309.                   login name.
  310.  
  311.           ----rrrroooowwwwssss _h_e_i_g_h_t
  312.                   This option specifies the maximum height, in lines
  313.                   of text, of the _x_l_b_i_f_f window.  The default is 20.
  314.  
  315.           ----ccccoooolllluuuummmmnnnnssss _w_i_d_t_h
  316.                   This option specifies the maximum width, in
  317.                   characters, of the _x_l_b_i_f_f window.  The default is
  318.                   80.
  319.  
  320.           ----rrrreeeesssseeeettttSSSSaaaavvvveeeerrrr
  321.                   If this option is set, _x_l_b_i_f_f will reset the screen
  322.                   saver when new mail comes in.  This is useful if
  323.                   you're doing something near your workstation but not
  324.  
  325.  
  326.  
  327.      Page 1                                          (printed 4/30/98)
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.      XXXXLLLLBBBBIIIIFFFFFFFF((((1111))))        UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((4444 OOOOccccttttoooobbbbeeeerrrr 1111999999991111))))         XXXXLLLLBBBBIIIIFFFFFFFF((((1111))))
  335.  
  336.  
  337.  
  338.                   on it.
  339.  
  340.           ++++rrrreeeesssseeeettttSSSSaaaavvvveeeerrrr
  341.                   Opposite of -resetSaver.
  342.  
  343.           ----uuuuppppddddaaaatttteeee _s_e_c_o_n_d_s
  344.                   This option specifies the frequency in seconds at
  345.                   which _x_l_b_i_f_f should update its display.  The default
  346.                   is 15 seconds.
  347.  
  348.           ----vvvvoooolllluuuummmmeeee _p_e_r_c_e_n_t_a_g_e
  349.                   This option specifies how loud the bell should be
  350.                   rung when new mail comes in.
  351.  
  352.           The following standard X Toolkit command line arguments are
  353.           commonly used with _x_l_b_i_f_f:
  354.  
  355.           ----ddddiiiissssppppllllaaaayyyy _d_i_s_p_l_a_y
  356.                   This option specifies the X server to contact.
  357.  
  358.           ----ggggeeeeoooommmmeeeettttrrrryyyy +_x+_y
  359.                   This option specifies the preferred position of the
  360.                   scan window.
  361.  
  362.           ----bbbbgggg _c_o_l_o_r
  363.                   This option specifies the color to use for the
  364.                   background of the window.
  365.  
  366.           ----ffffgggg _c_o_l_o_r
  367.                   This option specifies the color to use for the
  368.                   foreground of the window.
  369.  
  370.           ----xxxxrrrrmmmm _r_e_s_o_u_r_c_e_s_t_r_i_n_g
  371.                   This option specifies a resource string to be used.
  372.                   This is especially useful for setting resources that
  373.                   do not have separate command line options.
  374.  
  375.      RRRREEEESSSSOOOOUUUURRRRCCCCEEEESSSS
  376.           The application class name is XLbiff.  It understands all of
  377.           the core resource names and classes as well as:
  378.  
  379.           bbbboooottttttttoooommmm ((((class BBBBoooottttttttoooommmm))))
  380.                   Same as the ----bbbboooottttttttoooommmm option.
  381.  
  382.           ffffiiiilllleeee ((((class FFFFiiiilllleeee))))
  383.                   Same as the ----ffffiiiilllleeee option.
  384.  
  385.           ssssccccaaaannnnCCCCoooommmmmmmmaaaannnndddd ((((class SSSSccccaaaannnnCCCCoooommmmmmmmaaaannnndddd))))
  386.                   Specifies a shell command to be executed to list the
  387.                   contents of mailbox ffffiiiilllleeee.  The specified string
  388.                   value is used as the argument to a _s_y_s_t_e_m(3) call
  389.                   and may therefore contain i/o redirection.  The
  390.  
  391.  
  392.  
  393.      Page 2                                          (printed 4/30/98)
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.      XXXXLLLLBBBBIIIIFFFFFFFF((((1111))))        UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((4444 OOOOccccttttoooobbbbeeeerrrr 1111999999991111))))         XXXXLLLLBBBBIIIIFFFFFFFF((((1111))))
  401.  
  402.  
  403.  
  404.                   command's stdout is used to generate the window.
  405.                   Internally, the command is generated as
  406.  
  407.                                 sprintf(buf, scanCommand, file, columns)
  408.  
  409.                   so a %s and %d respectively in ssssccccaaaannnnCCCCoooommmmmmmmaaaannnndddd will
  410.                   generate the values of ffffiiiilllleeee and ccccoooolllluuuummmmnnnnssss.
  411.  
  412.           rrrreeeesssseeeettttSSSSaaaavvvveeeerrrr ((((class RRRReeeesssseeeettttSSSSaaaavvvveeeerrrr))))
  413.                   Same as the ----rrrreeeesssseeeettttSSSSaaaavvvveeeerrrr option.
  414.  
  415.           uuuuppppddddaaaatttteeee ((((class IIIInnnntttteeeerrrrvvvvaaaallll))))
  416.                   Same as the ----uuuuppppddddaaaatttteeee option.
  417.  
  418.           ccccoooolllluuuummmmnnnnssss ((((class CCCCoooolllluuuummmmnnnnssss))))
  419.                   Same as the ----ccccoooolllluuuummmmnnnnssss option.
  420.  
  421.           rrrroooowwwwssss ((((class RRRRoooowwwwssss))))
  422.                   Specifies the maximum height, in lines, of the
  423.                   _x_l_b_i_f_f window.  The default is 20.
  424.  
  425.           vvvvoooolllluuuummmmeeee ((((class VVVVoooolllluuuummmmeeee))))
  426.                   Same as the ----vvvvoooolllluuuummmmeeee option.
  427.  
  428.      AAAACCCCTTTTIIIIOOOONNNNSSSS
  429.           _X_l_b_i_f_f provides the following actions for use in event
  430.           translations:
  431.  
  432.           ppppooooppppddddoooowwwwnnnn(((())))
  433.                   This action causes the window to vanish.
  434.  
  435.           eeeexxxxiiiitttt(((())))  This action causes _x_l_b_i_f_f to exit.
  436.  
  437.           The default translations are
  438.  
  439.                   <Button1Press>:  popdown()
  440.                   <Button3Press>:  exit()
  441.  
  442.  
  443.      EEEENNNNVVVVIIIIRRRROOOONNNNMMMMEEEENNNNTTTT
  444.           DDDDIIIISSSSPPPPLLLLAAAAYYYY is used to get the default host and display number.
  445.  
  446.      FFFFIIIILLLLEEEESSSS
  447.           /usr/spool/mail/_u_s_e_r_n_a_m_e
  448.                   default mail file to check.
  449.  
  450.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  451.           _X(1), _s_c_a_n(1)
  452.  
  453.      BBBBUUUUGGGGSSSS
  454.           specifying dimensions in -geometry causes badness.
  455.  
  456.  
  457.  
  458.  
  459.      Page 3                                          (printed 4/30/98)
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.      XXXXLLLLBBBBIIIIFFFFFFFF((((1111))))        UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((4444 OOOOccccttttoooobbbbeeeerrrr 1111999999991111))))         XXXXLLLLBBBBIIIIFFFFFFFF((((1111))))
  467.  
  468.  
  469.  
  470.      CCCCOOOOPPPPYYYYRRRRIIIIGGGGHHHHTTTT
  471.           Copyright 1991, Digital Equipment Corporation.  See the
  472.           source code for a full statement of rights and permissions.
  473.  
  474.      AAAAUUUUTTTTHHHHOOOORRRR
  475.           Ed Santiago, santiago@pa.dec.com
  476.  
  477.      AAAACCCCKKKKNNNNOOOOWWWWLLLLEEEEDDDDGGGGEEEEMMMMEEEENNNNTTTTSSSS
  478.           _X_l_b_i_f_f took shape around the xxxxggggooooooooddddbbbbyyyyeeee sample program in the
  479.           O'Reilly _X _T_o_o_l_k_i_t _I_n_t_r_i_n_s_i_c_s _P_r_o_g_r_a_m_m_i_n_g _M_a_n_u_a_l.  A lot of
  480.           code was stolen from xxxxbbbbiiiiffffffff, including this man page.  Thanks
  481.           also to Stephen Gildea (gildea@expo.lcs.mit.edu) for the
  482.           many, many contributions that made _x_l_b_i_f_f grow from a
  483.           midnight hack to a more mature product.
  484.  
  485.  
  486.  
  487.  
  488.  
  489.  
  490.  
  491.  
  492.  
  493.  
  494.  
  495.  
  496.  
  497.  
  498.  
  499.  
  500.  
  501.  
  502.  
  503.  
  504.  
  505.  
  506.  
  507.  
  508.  
  509.  
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.      Page 4                                          (printed 4/30/98)
  526.  
  527.  
  528.  
  529.